# 镜像构建

***Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.***

---

# SDK下载与编译

## 支持型号

- **QSM565DP-WF**

## 下载SDK

您可以通过以下两种方式获取Quectel Pi H1的Linux SDK：

### 方式一：从官方网站下载

请访问 [Quectel开发者中心资源下载页面](<https://www.quectel.com.cn/download-zone>) 下载Quectel Pi H1 SDK编译资源包。

在资源下载页面，选择 **Quectel Pi** 产品类型，然后选择 **固件** 类型，找到对应的 **Quectel Pi H1 SDK编译资源包** 进行下载：

```{image} images/image_WUEvbE1pjoDDimxKgNOc9jfVnmg.webp
:width: 1909px
:height: 985px
:align: center
```

下载的SDK包包含：

- **预编译固件**：可直接用于烧录的镜像文件

- **编译工具链**（可选）：如需自定义开发，可进行二次编译

### 方式二：从GitHub克隆

您也可以直接从GitHub仓库克隆SDK源码：

```bash
git clone https://github.com/Quectel-Pi/Pi-H1-Linux-SDK.git
```

克隆完成后，进入 *Pi-H1-Linux-SDK* 目录即可开始使用。

**快速使用**  
如果您只需要使用官方固件进行烧录，**可以跳过下面的编译步骤**，直接跳转到 [获取镜像](#获取镜像) 章节，解压SDK包后即可获得所有烧录所需的镜像文件。

---

## 自定义编译（可选）

> **注意**：以下章节适用于需要修改源码或自定义配置的开发者。如果您只是使用官方固件，可以跳过此部分。

### 构建环境

**代码下载成功后，进入*Pi-H1-Linux-SDK*****主目录下，首先执行**:

```bash
source quectel_build/compile/build.sh
```

执行此命令后，终端会自动切换到 *build-qcom-wayland* 目录，这是正常现象。后续的 *buildconfig* 和 *buildall* 命令都将在此目录下执行。

**步骤一：** 执行如下命令构建环境：

```bash
buildconfig QSM565DWF QSM565DWFPIARL1A01_BL01BP01K0M01_QDP_LP6.6.0XX.01.00X_V0X STD
```

您可以根据提示输入用户定制的 *project_name* *project_rev* *custom_name*，从提示的 *Valid Projects* 和 *Valid CUST_NAME* 里面选择当前有效的字段进行用户定制。

配置成功后，您会看到当前的构建配置信息：

```plaintext
MACHINE    = qcm6490-idp
DISTRO     = qcom-wayland
BUILDTYPE  = default
BSP-TYPE   = qcom-custom-bsp
```

以及确认的项目配置：

```plaintext
Current QUECTEL_PROJECT_NAME = QSM565DWF
Current QUECTEL_PROJECT_REV  = QSM565DWFPIARL1A01_BL01BP01K0M01_QDP_LP6.6.0XX.01.00X_V0X
Current QUECTEL_CUSTOM_NAME  = STD
```

## AP侧整编

**步骤二：** 执行如下命令在AP侧进行整编：

```bash
buildall
```

此过程大概需要运行 **1~2小时**。  
编译过程中：  
出现 *When reparsing* 的错误请不用在意，不影响编译结果。

```bash
ERROR: When reparsing .....
ERROR: The following commands may help:
```

直到出现 *all succeeded* 表示编译成功。

```bash
NOTE: Tasks Summary: Attempted 15639 tasks of which 3 didn't need to be rerun and all succeeded.
```

## 一键打包

**步骤三：** 执行如下命令进行一键打包：

```bash
buildpackage
```

此过程会将编译好的镜像文件打包到指定目录，整个过程大约需要 **10~20秒**。

打包过程中会显示：

```plaintext
Process QSM565DWF type items
TARGET_DIR: /home/kane/Pi-H1-Linux-SDK/quectel_build/QSM565DWFPIARL1A01_BL01BP01K0M01_QDP_LP6.6.0XX.01.00X_V0X
===============copy image begin==============
```

当看到以下信息时，表示打包成功：

```plaintext
copy ap version successful
copy bootbinaries to TARGET_DIR successful
copy prog_firehose to TARGET_DIR successful
copy partition to TARGET_DIR successful
===============Build version success and build_time:0m13s===============
```

打包完成后，所有烧录所需的镜像文件都会被复制到目标目录。

# 获取镜像

根据您的使用场景，有两种方式获取镜像文件：

## 方式一：直接使用官方固件（推荐）

将从 [Quectel开发者中心](<https://www.quectel.com.cn/quectel-pi/developer-resources>) 下载的固件包进行解压，即可在解压目录中找到所有烧录所需的镜像文件。

```{image} images/image_AFpmb58cDomc8vxgdfRczc8FnJg.webp
:width: 1782px
:height: 776px
:align: center
```

## 方式二：自定义编译后获取

如果您完成了上述自定义编译步骤，编译后的镜像位于：**workspace/quectel_build/项目版本号**

---

## 镜像文件说明

镜像目录中包含以下主要文件：

**引导加载程序相关：**

- *xbl.elf* -主引导加载程序

- *xbl_config.elf* - XBL配置文件

- *uefi.elf* - UEFI固件

**系统镜像：**

- *system.img* -系统镜像文件（主要镜像）

- *dtb.bin* -设备树二进制文件

- *vmlinux* - Linux内核

- *kernel-modules.tgz* -内核模块

**烧录配置文件：**

- *rawprogram\*.xml* -原始编程配置文件

- *patch\*.xml* -补丁配置文件

- *gpt_main\*.bin* / *gpt_backup\*.bin* - GPT分区表

**其他固件：**

- *aop.mbn* - Always-On Processor固件

- *tz.mbn* - TrustZone固件

- *cpucp.elf* - CPU控制处理器固件

- *prog_firehose* - Firehose烧录工具